home *** CD-ROM | disk | FTP | other *** search
/ Aminet 24 / Aminet 24 (1998)(GTI - Schatztruhe)[!][Apr 1998].iso / Aminet / dev / e / AEPD24.lha / EPD24 / Amiga_E-Programme / AG2TXT / AG2TXT_v2.readme < prev    next >
Text File  |  1994-11-27  |  2KB  |  55 lines
  1. Short:    AmigaGuide to text (v2). E & C source.
  2. Author:   m88jrh@uk.ac.ox.ecs (Jason R. Hulance)
  3. Uploader: m88jrh@uk.ac.ox.ecs (Jason R. Hulance)
  4. Type:     text/hyper
  5.  
  6. Ag2Txt (v2)
  7. ===========
  8. Ag2Txt converts AmigaGuide files to highlighted text.  This text may be
  9. read using a standard text reader, or may be sent to a suitable printer.
  10. (The Amiga printer drivers handle the ANSI codes produced.)
  11.  
  12. There are three different versions of this program in the archive: two
  13. written in E (one for AmigaDOS 1.3 and one for 2.0+), and one in C. All
  14. three versions have the following syntax:
  15.  
  16.     ag2txt <amigaguidefile> [ <textfile> ]
  17.  
  18. The <textfile> is an optional output file.  If it is not specified or
  19. cannot be opened then the output is written to the terminal (stdout).
  20.  
  21. Version 2 of Ag2Txt knows a lot more AmigaGuide codes and handles them a
  22. lot better than version 1.  Also, version 1 omitted the C version, which
  23. was subsequently requested by a number of people.
  24.  
  25. You can customise the output by fiddling with the source.  The ansi codes
  26. used are confined to the function 'write_ansi' near the top of the source.
  27. One list is for turning on the appropriate attribute, and the second is
  28. for turning it off.  The C version is particularly dumb because the Xterms
  29. I use at work don't understand the 'turn off' codes so I took them out
  30. (and used just the 'set to plain' code, '\e[0m').
  31.  
  32. The AmigaDOS 2.0+ version uses the buffered I/O functions to gain a huge
  33. performance increase compared to the unbuffered I/O used in the AmigaDOS
  34. 1.3 version.  Also, the 2.0+ version uses Michael Zucchi's excellent
  35. 'async' module that comes with E v3.0 to get an extra 1/3 speed up (for
  36. reading, since 'async' doesn't do writes... yet??).
  37.  
  38. Legal stuff:
  39. The programs in this archive are Copyright (C) 1994, Jason R. Hulance.
  40. Apart from that the GNU Public License (Version 2) holds.
  41.  
  42.  
  43. ============================= Archive contents =============================
  44.  
  45. Original  Packed Ratio    Date     Time    Name
  46. -------- ------- ----- --------- --------  -------------
  47.     7485    2172 70.9% 16-Aug-94 09:49:12  ag2txt.c
  48.     4836    2516 47.9% 15-Aug-94 21:13:40  ag2txt13
  49.     7265    2191 69.8% 16-Aug-94 09:09:40  ag2txt13.e
  50.     5296    2877 45.6% 15-Aug-94 21:13:42  ag2txt20
  51.     7187    2198 69.4% 16-Aug-94 09:09:46  ag2txt20.e
  52.     1858     984 47.0% 16-Aug-94 09:50:00  ag2txt_v2.readme
  53. -------- ------- ----- --------- --------
  54.    33927   12938 61.8% 17-Aug-94 03:36:32   6 files
  55.